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A New Software Tool: ES-CAPE 


ES-CAPE stands for Extended S-C Applesoft Program Editor. You 
are somewhat familiar with it already as AED II from Linn 
Software. Bill has added more features, and I am in the 
process this month of re-doing the reference manual. I am 
shooting for it to be all packaged by the middle of July. The 
price will hold at $40 at least until September lst. 


If you are using Applesoft and feel the need for advanced 
editing tools to use on your programs-under-development, 
ES-CAPE ought to be in your tool-box. Like any tool, it 
doesn't do everything and it won't replace all your other 
tools. (You wouldn't try to tighten a screw with a hammer, or 
assemble a Heathkit with a SkilSaw....}) But neither does it 
use all your money or memory! 


Current Advertising Rates : 


For the August 1982 issue the price will be $60 for a full 
page, $35 for a half page. To be included, I must receive your 
camera-ready copy by July 20th. 


Run-Anywhere Subroutine Calls...........-BOob Sander-Cederlof 


Bob Nacon (author of Amper-Magic) called yesterday and told me 

about his new way to call subroutines in programs that will be 

loaded anywhere in memory without relocation or reassembly. He 
does this a lot inside Amper-Magic, and you might want to do it 
yourself sometime. 


Instead of JSR’ <subroutine name>, put the following three lines 
whenever you call a subroutine: 


CLV 
JSR SFF58 
BVC <subroutine name> 


The byte at SFF58 in the monitor ROM is always $60, an RTS 
instruction. Since this is used by most Apple interface 
boards, Apple has guaranteed that it will always be $60. The 
JSR to a guaranteed RTS instruction seems silly, doesn't it? 
Not quite, because it does put two bytes on the stack, and then 
pop them off again. But we can get them back later, inside the 
called subroutine, like this: 


TSX GET STACK POINTER 

BEX 

DEX 

TXS REVISED STACK POINTER 


Now the subroutine we called has a return address to go to, 

just as theugh we had used JSR <subroutine name>! The only 

problem is that if we execute an RTS. we will re-execute the 
BVC <subroutine name> and be in a loop. Unless.... 


Unless we set overflow, so the BVC falls through. But there is 
no SEV opcode in the 6502, so what do we do? SFF58 to the 
rescue again! Here is how we end the subroutine: 


BIT $FF58 SET OVERFLOW 
RTS 


The BIT instruction copies bit 7 of S$FF58 into the Carry Status 
bit, and bit 6 into the Overflow Status bit. This, in other 
words, (since $FF58 has $60 in it) clears carry and sets 
overflow. If you want carry to be set as a return flag, you 
can insert SEC between the BIT and RTS lines. 


I thank Bob Nacon for this technique, and he thanks Roger 
Wagner for putting him on the trail to its discovery. Roger 
writes the monthly column in Softalk Magazine called “Assembly 
Lines"; the December, 1981, issue covered writing run-anywhere 
programs. If you haven't got Roger's book yet, called 
“Assembly Lines: The Book", it is currently the best book for 
beginners that I know of. The regular price is $19.95+§2 
shipping, but I sell them for $18+$2 shipping. 
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Still More About "The Other Epson Reference Manual" 


No sooner did I print my cutting comments about Cut The Bull 
Software last month, than I received a copy of the new edition 
of "The Other Epson Manual" in the mail. Bill Parker, author 
and publisher, has done an excellent job. By now all of you 
who ordered the booklet should have received your copy. 


Bill has now quit his previous job to devote full time to the 
software company. The nature of that previous job prevented 
him from publishing his telephone number. Now you can reach 
him at (714) 223-3576. He says that in the future should a 
back order situation develop he will hold customer checks until 
ready to ship. 


Cut The Bull Software 


Box 82761 ® San Diego, CA 92138 


Boy, the Bull really saw red after reading last 
month's Apple Assembly Line. 

fo clarify a few things, all back orders have been 
shipped, my home phone number is 223-3576, and we are now 
earning compliments on our speed and service. 

We were swamped during the first two months of business. 
Seems we struck a nerve with the Other Epson Manual. 
Complicating things were our inexperience with starting a 
new business, the fact that the review didn't make clear 
what configuration of Epson the original Epson Manual was 
for, and the fact that there was just Mrs. Bull and me 
packing orders for 18 hours a day. 

We now have The Epson Card, a series of flip charts 
for the MX-80 without Graftrax and The Other Epson Manual, 

a beautiful 40-page manual on the MX-80 with Graftrax 80. 
The manual includes many special features such as a HIRES 
screen dump, an address of a newsletter that shows you how 
to use your Epson with a variety of firmware and software, 
a reference card, etc. etc. More manuals are on the way. 

To help say sorry for any inconvenience, we are offering 
MX-80 with Graftrax 80 Other Epson Manual owners an update to 
version 3.1 of the manual for only $5. (The manual costs $10). 
The disk will be updated for free; just send it and return 
postage. Or, if they prefer, customers can have a copy of 
the two most significant changes in the manual, the HIRES 
screen dump and the non-Epson interfacing & newsletter info 
for a stamped, self-addressed envelope and 25¢. Just include 
a note saying what you want. 


Sincerely, 

DBM Math. 
Bill Parker, President 
Cut The Bull Software 


P.S. --Bill enclosed for 14 china stores destroyed in rampage. 
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Who are “we" and what are "we" doing?...........-Mike ILaumer 


Some of you may wonder about the people whose articles you see 
in the AAL on a fairly regular basis and who you may have 
talked to on the phone at one time or another. 


Bob Sander-Cederlof is the president of the S-C Software 
Corporation and the author of the S-C Assemblers and Double 
Precision Floating Point package. Bob has been working with 
computers since 1957, at such places as Control Data 
Corporation and Texas Instruments. He is developing a new text 
editor somewhat compatible with Apple Writer. Believe it or 
not the editor is half the size of Apple Writer. Both the 
editor and printer sections are in memory at once and it has 
more capabilities than Apple Writer. He also edits this 
newsletter every month, with the aid of Bill Morgan. 


Bill Morgan is Bob's first full-time employee and helps in all 
area8: programming, shipping, accounting, phone sales, and 
writing articles for the AAL. He helps author the reference 
manuals as well, and tries to make our products fail before we 
start shipping them (so we can fix ‘em before you see ‘em!). 


Bobby Deen is a part-time employee still in high school. He is 
currently helping Bob S-C develop a line of compatible Macro 
Cross Assemblers for 6800, 6809 and Z-80 processors to round 
out Bob's assembler product line. (The 6800 and 6809 versions 
are ready now.) He has helped develop an 18-digit decimal math 
package compatible with Applesoft soon to be a new product. He 
has also assisted in the CPR project with Mike Laumer. 


Mike Laumer (that's me!) is owner of Laumer Research and author 
of FLASH! the Integer BASIC compiler, and of the upcoming 
MIKE'S MAGIC MATRIX hires graphics editor and animation design 
tool. As a sub-contractor to S-C Software for the last year, I 
have been working on an incredible application using Apples and 
video disks. You can read all about it in the June 1982 issue 
of BYTE magazine, pages 108-138. The American Heart 
Association sponsors the project, which will teach 
Cardiopulmonary Resuscitation (CPR). The Apple is supported by 
a video disk player, light pen, two CPR manikins, a 
random-access audio unit, and two monitors. 


If you have called, you may have talked with Bob's daughter 
Patricia (oldest of five children). She is a Junior in High 
School, and works part-time at shipping, phone sales, mailing 
list maintenance, word processing, Visicalc-ing, program entry, 
paste-up and folding, and whatever comes up. She is assisted 
by Lisa MacCorkle, another high school friend. 


We enjoy talking with all of you, so if you have a problen, 
need a book, or whatever, give us a call! 
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Decision 


Decision Systems 
S P.O. Box 13006 
ystems Denton, TX 76203 
817/382-6353 


DIS-ASSEMBLER 


DSA-DS dis-assembles Apple machine language programs into forms 
compatible with LISA, S-C ASSEMBLER (3.2 or 4.0), Apple's TOOL- 
KIT ASSEMBLER and others. DSA-DS dis-assembles instructions or 
data. Labels are generated for referenced locations within the 
machine language program. 

$25, Disk, Applesoft (32K, ROM or Language card) 


OTHER PRODUCTS 


ISAM-DS is an integrated set of Applesoft routines that gives indexed file capabilities 
to your BASIC programs. Retrieve by key, partial key or sequentially. Space from 
deleted records is automatically reused. Capabilities and performance that match 
products costing twice as much. 

$60 Disk, Applesoft. 


PBASIC-DS is a sophisticated preprocessor for structured BASIC. Use advanced 
logic constructs such as IF...ELSE..., CASE, SELECT, and many more. Develop 
programs for integer or Applesoft. Enjoy the power of structured logic at a fraction of 
the cost of PASCAL. 

$36. Disk, Applesoft (48K, ROM or Language Card). 


FORN.-DS is a compiete system for the definition of input and output froms. FORM - 
DS supplies the automatic checking of numeric input for acceptable range of values, 
automatic formatting of numeric output, and many more features. - 

$25 Disk, Applesoft (32K, ROM or Language Card). 


UTIL-DS is a set of routines for use with Applesoft to format numeric output, selec- 
tively clear variables (Applesoft’'s CLEAR gets everything), improve error handling, 
and interface machine language with Applesoft programs. Includes a special load 
routine for placing machine language routines underneath Applesoft programs. 

$25 Disk, Applesoft. 


SPEED-DS is a routine to modify the statement linkage in an Applesoft program to 
speed its execution. Improvements of 5-20% are common. As a bonus, SPEED-DS 
includes machine language routines to speed string handling and reduce the need for 
garbage clean-up. Author: Lee Meador. 

$15 Disk, Applesoft (32K, ROM or Language Card). 


(Add $4.00 for Foreign Mail) 


“Apple il is a registered trademark of the Apple Computer Co. 
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Giant Macro for Writing MessageS.......++.e+--eROobert B. Steiner 


Every time I turn around I seem to need a quick and dirty 
routine to print out a message. I must have written them a 
dozen different ways, to fill various requirements. Sometimes 
they are only different because of a silly mistake...a 
difference usually called a bug. I could keep a handful of 
them on a subroutine library, but then I might get mixed up as 
to which one was which. 


S-C Macro Assembler to the rescue! By writing one of largest 
macros I have ever seen, I can get all the 
message-printer-variants into one neat little package. Then by 
choosing the correct parameters, the kind of printing routine I 
want is generated on the spot. 


I call the macro CRT, and you call it with up to five 
parameters. The call line will look like one of these: 


>CRT L,N, “your message" 
>CRT L,I,"your message" 
>CRT A,N,address of your message 
>CRT A,I,address of your message 


The first parameter, which may be "L" or "A", indicates whether 
you will give an actual message in quotation marks, or the 
address of the message. 


The second parameter, which may be "N* or "I", stands for 
Normal or Inverse video display. 


The third parameter is either the message itself in quotes, or 
the address of the message (a label, of course). 


An optional fourth parameter may be "I", "Y", or "R". "I" will 
generate code to read an immediate one byte reply, which is 
returned in the A-register. "Y" will generate the one byte 
reply code, followed by additional code to check for a yes/no 
response. It will loop until you type "Y" or "N"; then it will 
echo the letter, print a RETURN, and return with the character 
in the A-register. 


If the fourth parameter is "R",an entire line of reply is 
expected. If there is no fifth parameter, the line will be at 
$200 for your program to analyze. If a fifth parameter is 
used, it is the name of a buffer for the reply message. 


If I counted correctly, there are twenty different possible 
ways the macro can be generated! 


Here is the macro definition, and some sample call lines. Try 
it out; you'll find it fun and educational, whether its useful 
to you or not. Then you can apply some of the techniques in 
your own work. 
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—— APPLE OWNERS LOVED FIRE ORGAN (WHICH WAS FREE) -—— 


es, 


“.2-AM FASCINATED BY FIRE ORGAN...” 
STEVE WHEELER, AURORA CO 


“THANK YOU FOR FIRE ORGAN. WE’VE HAD IT FOR 24 HOURS NOW AND HAVE NOT 
GOTTEN ANY WORK DONE." 
DON MCMATH, TULSA OK 


“.-BEEN WATCHING FOR CEEMAC EVER SINCE I GOT THE FREE COPY OF FIRE 
ORGAN. 
ED JACKSON, FORT WORTH TX 


".eHAVE SHOWN FIRE ORGAN OVER LOCAL TV... (WITH)...MUSIC FROM A 
CABLE-ONLY, PROGRESSIVE RADIO STATION. ...IT WAS THE BEST SHOW WE’ VE 
PUT ON YET." 

JIM AIKIN, GAINESVILLE FL 


"..-HAVE SPENT MANY ENJOYABLE SUNDAY AFTERNOONS WITH FIRE ORGAN. 
THANKS MUCHLY.” 

B GARBEE, LYNCHBURG VA 
“YOUR ’FIRE ORGAN’ IS SO AMAZINGLY APPEALING..." 

RODNEY A WHITE, GLENDALE CA 
“.ee THINK THAT FIRE ORGAN IS ONE OF THE MOST IMPRESSIVE THINGS EVER 


DONE WITH AN APPLE.” 
AL EVANS, AUSTIN TX 


“MY STUDENTS ARE DROOLING AT THE IDEA OF ’*MAKING STUFF LIKE FIRE 
ORGAN’ AND SO AM I." 
MATT BERMAN, METAIRIE LA 


“FIRE ORGAN IS TERRIFIC! WHERE AND HOW CAN I GET ”’CEEMAC’?" 


D WALKER, ALTAMONTE SPRINGS FL 
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——- NOW THEY’RE LOVING CEEMAC (WHICH ISN’T FREE) —— 


i 


“A RECENT DEMONSTRATION OF (CEEMAC) ... REALLY EXCITED ME." 
MICHAEL CALLERY, NEW YORK NY 


"..YOU HAVE DEVELOPED THE SYSTEM I HAVE BEEN LOOKING FOR..." 
BILL COZAD, KANSAS CITY MO 


“FIRE ORGAN IS PROBABLY THE SINGLE MOST IMPRESSIVE USE OF THE APPLE 
GRAPHICS CAPABILITIES YET SEEN, AND WITH CEEMAC AVAILABLE SO THAT 
OTHERS CAN WORK WITH IT, THE PROGRAMMER’S CAPABILITIES WILL EXPAND A 


THOUSANDF OLD. * 
RICK E BERGER, PRINCETON NJ 
“.2e-YOU HAVE OBVIOUSLY TAKEN GRAPHICS TO A NEW STATE OF THE ART.” 
CHUCK CARLSON, TULSA OK 


“THERE IS NO QUESTION IN MY MIND THAT CEEMAC IS THE MOST ORIGINAL, 
MOST USABLE APPLE GRAPHICS PACKAGE I HAVE SEEN (AND I THINK I HAVE 


SEEN THEM ALL)." 
BILL DWYER, CUPERTINO CA 


“YOU HAVE MADE A GREAT CONTRIBUTION TO BOTH ART AND SCIENCE WITH YOUR 
WORK.” : 
M AINSWORTH-LAND, BUFFALO NY 


“THANK YOU FOR THE TIME SPENT IN DEVELOPING A TRULY UNIQUE AND USEFUL 
PROGRAM. ° 
BILL BOYDSTON, GLENDALE CA 


"IT’S IMMEDIATELY OBVIOUS TO ME THAT CEEMAC IS EVERYTHING I HAD HOPED 


FOR.. AND MUCH MORE.” 
DOUG S YATSUHASHI, NORFOLK MA 


SEE AND TRY CEEMAC AT YOUR NEARBY APPLE DEALER. 
RELEASE 1.0 - 875 


VAGABONBDO ENTERPRISES 
13500 E ALGONQUIN - 3S& 
SCHAUMBURG IL - 60195 


APPLE If IS A TRADEMARK OF APPLE COMPUTER, INC 
CEEMAC AND FIRE @RGAN ARE TRABEMARKS OF VABABONDO ENTERPRISES 


Apple Assembly Line... eJuly, 1982....Copyright (Cc) s-c SOFTWARE....Page 9 


Sorting Out Zero-Page ReferencesS.......eeeeeeTracy L. Shafer 


The search for page-zero references program in last month's AAL 
turned out to be (almost) the very thing I've been needing. 


I have a clock card capable of generating NMI and IRQ 
interrupts. Up to now. I haven't been able to do any deep 
research on the IRQ due to the DOS and monitor conflict 
mentioned in the January issue of AAL. (They both use location 
$45.) I can't modify the monitor because I don't have access 
to a PROM burner, and the thought of searching through DOS 
really put a damper on the IRQ project until now. 


Since I didn't need to know every page-zero reference used by 
DOS, I modified the program to search for a specific page-zero 
reference. That worked fine, but I didn't want to have to type 
in a separate search value for every group of references I 
might need later, so I further changed the program to print out 
all the references in numerical order of page-zero location. 


To make the changes to the program as published last month, 
just remove the ".3" from line 1580 and add the following 
lines: 


1285 PAGE.REF .HS 00 VARIABLE TO HOLD THE 
CURRENT ZERO-PAGE 
LOCATION 

1571 .3 INY NEW PLACE FOR ".3" LABEL 

1572 LDA (MON.PCL) ,Y GET PAGE REFERENCE 

1573 DEY RESTORE VALUE OF Y 

1574 CMP PAGE.REF ONE WE ARE SEARCHING FOR? 

1575 BNE .6 NO, IGNORE THIS ONE 

1861 LDX #1 RESTORE X-VALUE FOR 
MON-A1PC ABOVE 

1862 INC PAGE.REF NEXT ZERO~PAGE ADDRESS 

1863 BNE CTRL.Y NOT FINISHED 


The program now searches through the memory range 256 times 
instead of just once, so it doesn't run nearly as fast, but 
it's easier to find all the references to specific locations. 
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AXLON RAMDISK 320: A ReVieW..cccccccccvcesccccccccceeBlll Morgan 


AXLON's RAMDISK 320 is a system designed to add 320K of memory 
to an Apple, configured to look to the Apple like two very fast 
disk drives. The speed improvement ranges from half the time 
for a large assembly to one-twelfth the time for directly 
dumping 192 pages of memory. 


Hardware 


The RAMDISK is a cabinet just the size of an Apple disk drive, 
containing the memory. its own power supply, and a backup 
battery. There is also a large interface card, which includes 
2K of static RAM for the operating system. 


The backup battery is said to provide up to three hours of 
protection against power outage. It did maintain power when we 
moved the system into another room (about 5 minutes), but you 
should certainly make floppy disk backups of the RAMDISK data 
before leaving the system unplugged overnight. As long as it 
is plugged into the wall, the battery is kept charged and the 
memory is maintained. 


Software 


There are several programs supplied with the RAMDISK. These 
fall into the general categories of system software, utilities, 
and demonstrations. 


RAMDSK1 is the operating system, which is stored in static RAM 
on the interface card, addressed in the $C800-CFFF space. 
BRUNning this program hooks it into DOS and copies one or two 
mechanical drives into the RAMDISK. 


RDCOPY copies between the mechanical and RAM disks, to load or 
back up the RAMDISK. SELECT creates modified versions of 
RAMDSK1 for different slot/drive configurations. 


The EXTRA40K utility allows you to access "tracks" 36-40 on the 
RAMDISK, but only on a level comparable to using RWTS directly. 
That is, you must work in terms of addresses and track/sectors 

rather than variables and filenames. The manual has a complete 
assembler source listing of this program. 


SECTOR CHECKER and BYTE-BY-BYTE are self-test utilities to 
verify correct operation of the RAMDISK. 


The demonstrations are The Directory and the Mini-Base Phone 
Book. The Directory is a large, disk-based, data-base progran, 
in machine language, which uses the speed of the RAMDISK to its 
full advantage. The problem with this program is that it is 
strictly fixed-format, with no provision for modifying the 
record structure. The fields built into a record are last 
name, first name, dept #, mail stop, phone, special interest l, 
special interest 2, and comments. If you are a large company 
needing an on-line. internal phone directory, then The 
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Directory is outstanding. Otherwise, it's just an interesting 
demonstration of the system's capabilities. 


The Mini-Base Phone Book is a memory-based data base, somewhat 
similar to File Cabinet. The Mini-Base is also set up as an 
internal phone directory. but since it is written in Applesoft, 
it can be modified to suit your needs. The documentation 
includes instructions for changing the record structure. The 
Manual also contains instructions for calling special 
machine-language routines for keyboard input, fast loading of 
text files (in a specified format), and fast sorting of a 
string array. 


Documentation 


The manual is in three sections: 63 pages on the system, 34 
pages on The Directory program, and 43 pages on the Mini-Base 
Phone Book program. It all comes in a large (8 1/2 by 11) 
3-ring binder. The system section has chapters on setting up 
the RAMDISK, using the included software, calling it from DOS 
3.3, attaching and using it in Pascal, technical information, 
and accessing the system from assembly language. 


The setup and software chapters are quite good; the DOS chapter 
just says that everything is standard. I don't have Pascal, so 
I can't evaluate that section. The technical and assembly 
language chapters have all the information about memory usage, 
addressing, and programming techniques needed to use the 
RAMDISK without all of DOS's overhead. 


Using the RAMDISK 


To use the RAMDISK with your programs, you need to copy the 
RAMDSK1 program onto your disk and set up the HELLO program to 
BRUN RAMDSK1. This will load the operating system into the 
interface card, then fast-copy your disk into drive one of the 
RAMDISK. Once your information is loaded into the RAMDISK, you 
can use all the normal DOS techniques to read and write files; 
the only difference is speed. 


You can avoid the DOS overhead either by calling RWTS in the 
usual manner, or by directly using the RAMDISK registers and 
memory window. To do that, you just store track, sector, and 
drive information into two bytes, then read the data from 
SC800-C8FF. This approach is fastest. but you must then take 
on all memory management chores. Appendices to the manual list 
assembler source code for routines using both techniques. 


The Negative Side 


We discovered one apparent bug in the RAMDISK's operating 
system. The program does not properly update the slot and 
drive found parameters in the I/O Control Block used by RWTS. 
If a program tries to use those locations to determine which 
drive it was run from, it will get the wrong data. 
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Mechanical disk drives are known to be error-prone, so DOS has 
some built-in protection against errors. Each sector is 
recorded with a checksum; when a sector is read the checksum 
should match. This is very poor protection, but it does catch 
most errors. The RAMDISK has no such protection. The RAMDISK 
is much less likely to have any errors than the mechanical 
drives, yet it still would be nice to have at least a sector 
checksum. Parity on each byte would be even better, but it 
would be expensive. 


Timing Comparisons 


Operation Disk II time RAMDISK time 
Assemble 102 sectors 89 sec. 41 sec, 
of source code. 
BLOAD Hi-res screen. ll sec. 3 sec, 
LOAD Applesoft program. 14 sec. 4 sec. 
Dump RAM (192 sectors) 9 sec. -8 sec, 
calling RWTS. 
Dump 192 sectors direct n/a ~7 sec. 
Summary 


The RAMDISK is a well-made and well-documented unit; it 
performs as advertised. The RAMDISK gives a terrific speed 
improvement over mechanical disk drives, especially if you do 
your own reading and writing and avoid DOS. 


Two standard Apple drives with controller at normal retail 
prices would cost $1180; RAMDISK goes for $1395, and you get 
the equivalent of 10 extra tracks thrown in. (On the other 
hand, several non-Apple drives are available with 40 to 80 
tracks, at competitive prices. And the 5- and 10-megabyte 
Winchesters are rapidly falling in price.) 

I have seen RAMDISK advertised for as low as $1170 in Byte 
Magazine. 


The RAMDISK 320 is available from AXLON, Inc., 170 N. Wolfe 
Rd., Sunnyvale, CA 94086, (408) 730-0216. RAMDISK 320, The 
Directory. and Mini-Base Phone Book are trademarks of AXLON 
INC. 
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Quick TRACE 


relocatable program traces and displays the actual machine operations, while it is running 
without interfering with those operations. Look at these FEATURES: 


Single-Step mode displays the last instruction, 
next instruction, registers, flags, stack contents, 
and six user-definable memory locations. 


Trace mode gives a running display of the Single- 
Step information and can be made to stop upon 
encountering any of nine user-definable 
conditions. 


Background mode permits tracing with no display 
until it is desired. Debugged routines run at near 
normal speed until one of the stopping cond- 
Itions is met, which causes the program to return 
to Single-Step. 


QUICK TRACE allows changes to the stack, 
registers, stopping conditions, addresses to be 
displayed, and output destinations for all this 
information. All this can be done in Single-Step 
mode while running. 


Two optional display formats can show a sequence 
of operations at once. Usually, the information 
is given in four lines at the bottom of the screen. 


QUICK TRACE is completely transparent to the 


program being traced. It will not interfere with 
the stack, program, or I/O. 


QUICK TRACE is relocatable to any free part of 
memory. Its output can be sent to any siot or to 
the screen. 

QUICK TRACE is completely compatible with 
programs using Applesoft and Integer BASICs, 
graphics, and COS. (Time dependent DOS 
operations can be bypassed.) It will display the 
graphics on the screen while QUICK TRACE Is 
alive. 

QUICK TRACE Is a beautiful way to show the 
incredibly complex sequence of operations that 
a computer goes through in executing a program 


QuicKTRACE $50 


Is a trademark of Anthro-Digital, Inc. 
Canvrichr © 1981 


See these programs at participating Computerland and other 


fine computer stores. 


Anthro - Digital Software, Inc. 


P.O. Box 1385 Pittsfield, MA 01202 
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Simple HireS Animation... .cccccccccvccccseccesceeMike Laumer 


One thing that I have been working with in my next product 
(MIKE'S MAGIC MATRIX) is animation uSing hires graphics. I 
have been developing a hires graphics editor using the FLASH! 
Integer BASIC Compiler. I may not be the first one to bring a 
commercial product to market using the FLASH! compiler since 
there are at least six other programmers who are striving to 
beat me. 


There are several methods used to achieve animation in the 
popular game programs. The one presented in this program is 
possibly the simplest. This program will animate an image in 
one place on the screen (in-place animation) from a series of 
frames of data. 


The technique used to display the frame data on the screen is 
simply moving the data with 'LDA' and 'STA' instructions. A 
more powerful method of animation is to use the 'EOR' 
instruction to merge one frame of animation into the next. 
This is accomplished by using the frame data obtained by 
"EOR'ing two successive frames of data. Then using that new 
data to ‘EOR' to the image data. The 'EOR' istruction is very 
useful since it can add and delete data to and from the screen 
without disturbing any background that may be on the screen 
already. 


A frame of data for the animation is written to the screen and 
then a delay loop entered to delay before the next data frame 
is written to the screen. If the delay is smaller the 
animation will speed up. If the delay is larger the animation 
will slow down. The delay could be read from the game paddle. 


The method I used in the routine to compute the hires graphics 
screen addresses is to use two tables (one for lo-byte, one for 
hi-byte) with 192 entries to convert the Y-coordinate into a 
hires address. Otherwise, the Y-addresses would have to be 
computed by using a complicated formula: 


A = Y MOD 8 
B= (Y / 8) MOD 8 
C=yY/ 64 


YADRS = 8192 + A*1024 + B*128 + C*40 
(add another 8192 if hires page2 adress needed) 


So you see that even with an efficiently coded machine language 
routine to compute a screen address it will take a bit of time 
to perform. It is much more effecient to simply look up the 
address of the first byte of the Y-row in a table. Since the 
Y-coordinate never exceeds 191 (which is less than 256) the 
Y-register can be used easily to index the table. The table in 
the program only provides the offset from the beginning of a 
hires page. The program uses an 'ORA' instruction to put $20 
or $40 into the hi-byte to specify hires page 1 or 2. 
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The data for the animations were built with MIKE'S MAGIC MATRIX 
and the first frame looks like this: 


Stara yb ere sop Erte deteraneyca esas ove artes ee QOOOOOGO Q QO Q G 
pote tates Ls ct ci ght igh ad eet Gat a Nak mise ete Q0000000 e) Q QO s) 
Eee were eee oe ne er NO6OOZO0 Oo 96 es Q 
Terre er eee 2 2 2S 6 eee ee ee ee 00700700 QO 112 7 @) 
ae brielses fe eae oe 2 ie o Seen eee OOSBoODa0 oO 88 13 © 
Sha aan eas ede KEKKEKEKL we 00780F 00 Qo 120 1S QO 
Soe. ar eee oN oe BE Wie wt Sees OOSBOEOO Oo 56 14 Q 
So ese ce ee etie MEKKKKK. C2 eee wees 00700700 QO 112 7 © 
ee eee eee © os Senne ery eee QNHOOSOO Oo 96 S Q 
rr ee te eee ee ee ee ee eee ee 00400100 QO 64 1 QO 
eee a ee ee ae, © on eer ee eer erm 00400100 Oo 64 1 QO 
eves ee ew eee RMERRRERR Sik ele wee 00780F00 O 120 15 oO 
cecn eww we MEREREREES. Cc cece ae OO7CIFOO oO 124 31 Q 
See eee es Sere 2 oe eee & See ee 00663300 oO 102 Sl oO 
aa cate e eso Me eee Be Gece BR Rig e868 00436100 O 67 97 O 
Sore! Ceen © 6 Sees © ieee 00636300 Qa 99 99 Q 
ceeeew a BR. o RRR EL KR occ ce es 00736700 oO 115 103 © 
eee s © eee 6 2 oe oe eee & eee 40714701 64 113 71 1 
vce we we SEC RRR. ERR OER ccc es 4OS94E01 64 S37 78 1 
Tere ee eee See 2 Saar a eae 00180C00 O 24 12 Q 
ee ee ee ee, eee See ere ee O0O1B80CO00 oO 24 12 QO 
ere eT ee ee © Cee ee. ee ee ae eee 00180C00 QO 24 12 @) 
ees ee a eae eS ee ee ae eee ae eae 0O0180C00 QO 24 12 © 
d WiSoeree @ are ee Bee aoa BR Res ewe eee wk 00180C00 Qo 24 12 QO 


The data was written to a text file from within the editor and 
run through an Applesoft program to create an EXEC file for the 
S-C Macro Assembler to insert the data tables into the program. 


Makes working with 
an Apple and an Epson a 
lot easier than trying to 


The understand Radio Shack 
humor. Includes HIRES 
Other dumps & much more! 
Plain English, easy 


to use routines & fig- 


Epson ieen. 
| The Other Epson Man- 
Manual ual with Graftrax 80, $10 


plus $1.50 post. & hand. 
(Calif. res. add 6% tax). 

Ask about our other 
Epson manuals or write 
for a catalog. 


CUT THE BULL SOFTWARE 
Box 82761 
san Diego, CA 92138 
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You can make your own frames of animation by a hand process of 
drawing the animation dots on graph paper and reducing the data 
into hexadecimal data. To do this you must take each row of 
dots (on or off) on the graph paper and take them 7 dots ata 
time. The 7 dots must then be flipped into reverse order 
before converting into hex. Here is an example of 14 pixels 
width: 


012345601234 5 6 


As you can see the process is a pain in the neck. If the 
animation has a flaw in it you have to repeat the process for 
every frame of data that is wrong. That is where a hires 
graphics editor and animation design tool like MIKE'S MAGIC 
MATRIX really shines, because you can perfect your animation 
and test it in the editor without ever leaving. MIKE'S MAGIC 
MATRIX is not yet ready for sale lacking a manual and a little 
more work. I expect to have the first version ready in about 
two more months. Preliminary showings to the Dallas Apple 
Corps indicated an enormous popularity. 


Since hexadecimal strings take up a lot of listing space when 
they are assembled, I decided to print the tables here using 
just the LIST command, without the assembled object code 
listing. The program part is shown in the normal assembled 
format. 


Here is what you will see if you get it all typed correctly: 


BERR RK REE 


Of course, they will all appear one after the other in the same 
screen position, not side-by-side. 
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1000" S2eseeeebe cece uceseecsce esc eco 
1010 Weeosetesecu. tote cee oe 
1020 ® SIMPLE ANIMATION 
FCA8- 1040 MON .WAIT .EQ = MONITOR DELAY ROUTINE 
0000- 1020 T1 .EQ 
0002- 1070 T2 .EQ 23 
0004- 1080 T3 -EQ $4; 
0006- 1090 Y. INDEX “EQ $6.7 
1110 # ANIMATION PLAYBACK LOCATIONS 
0020- 1130 HIRES.PAGE .EQ $20 = PAGE 1, $40 = PAGE 2 
0064- 1140 Y.COORD .EQ 50 WHERE TO PUT ANIMATION 
0014- 1150 X. COORD .EQ 20 WHERE TO PUT ANIMATION 
1170 .OR $803 
1180 : -TF B. ANIMATE 
0803- 20 3C 08 1200 START JSR HIRES.INIT INITIALIZE HIRES SCREEN 
0806- 20 0C 08 1210 .1 JSR PLAY.FRAMES PLAY 1 SET OF FRAMES 
0809- 4C 06 08 1220 : JMP .1 GO DO IT AGAIN 
O80C- Ag 00 i3ho PLAY.FRAMES LDA #0 INIT FRAME INDEX 
O80E- 8D 74% 08 1250 STA FRAME. INDEX 
0811- AD 74 08 1260 .1 LDA FRAME.INDEX GET FRAME INDEX POINTER 
0814- C9 09 1270 CMP #NUM.FRAMES HAVE ALL FRMES BEEN DONE 
0816- FO 23 1280 BEQ .3 YES, SO RETURN 
0818- AC 00 CO 1290 LDY $CO00 HAS A KEY BEEN PRESSED 
081B- 10 09 1300 BPL .2 NO, SO KEY PLAYING THE FRAMES 
081D- AD 51 CO 1310 LDA $C051 RESTORE TEXT SCREEN 
0820- AD 54 CO 1320 LDA $C054 PRIMARY PAGE 
0823- 4C DO 03 1330 JMP $3D0 EXIT ON ANY KEY 
0826- OA 1340 .2 ASL DOUBLE INDEX 
0827- A8 1350 TAY 
0828- B9 62 08 1360 LDA FRAME.TABLE,Y GET TABLE ADDRESS 
082B- 85 00 1370 STA T1 SAVE ADRS IN T1 
082D- C 1280 INY NEXT BYTE OF ADRS 
082E- B9 62 08 1390 LDA FRAME.TABLE,Y 
0831- 85 01 1460 STA T1+1 
0833- 20 75 08 1410 JSR ANIMATE MOVE FRAME DATA TO SCREEN 
0836- EE 74 08 1420 INC FRAME.INDEX NEXT FRAME 
0839- DO D6 1430 BNE .1 .. ALWAYS 
083B- 60 14ho 33 RTS 
1 eas cos ent ni cine ai Gems uw an ses ons Gem is es ns ss ss es 
083C= AQ 20 1460 HIRES.INIT LDA #HIRES. PAGE 
083E- 85 01 1470 A T1+1 
O840- AO 00 1480 LDY #0 
O842- 84 00 1490 STY T1 
O844- 98 1500 .0 TYA ZERO A REG 
0845- 91 00 1510 .1 STA (T1),Y | CLEAR SCREEN PAGE 
O847~ C 1520 INY 
O848- DO FB 1530 BNE .1 
O84A- E6 01 1540 INC Ti+1 NEXT PAGE 
OB4C- AS 01 1550 LDA T1+1 CHECK FOR 
OB4E- 29 1F 1560 AND #$1F END OF HIRES PAGE 
0850- DO F2 1570 BNE .0 CLEAR MORE 
0852- AD 50 CO 1580 LDA $C050 ENABLE GRAPHICS 
0855- AD 57 CO 1590 LDA $C05 ENABLE HIRES 
0858- AD 54 co 1600 LDA $C05 ENABLE PAGE 1 (C055 IS PAGE 2) 
O85B- AD 52 CO 1610 LDA $C052  NOMIX 
O85E- 60 1620 RTS 
1630 Deo eee eee ceeeecee eecesaeceees 
O85F- 14 1640 INTER.FRAME.DELAY .DA #20 
0860- 04 1650 XSIZE .DA #4 X FRAME SIZE IN BYTES 
0861- 18 1660 YSIZE <:DA #24 Y FRAME SIZE IN BYTES 
1670 FRAME. TABLE 
0862- 3F OA 1680 .DA FRAME1 
O864—- OF OA 1690 .DA FRAME2 
0866- FF OA 1700 -DA FRAME 
0868- 5F OB 1710 .DA FRAME 
O86A~ BF OB 1720 -DA FRAME5 
086C- 1F 0C 1730 .DA FRAME6 
O86E- 7F 0C 1740 ;DA FRAME 
0870- DF 0C 1790 -DA FRAME 
0872- 3F OD 1760 -DA FRAME9 
0909~ 1770 NUM.FRAMES .EQ 9 
0874- 00 1780 FRAME.INDEX .DA #0 
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1790 @acceseeeccew se ecccee es eeeecceeeee 

0875- AQ 64 1$80 ANIMATE LDA #Y.COORD THIS IS THE STARTING ROW 
087 - 85 06 1810 STA Y, INDEX FOR THE ANIMATION 

0879- ac 61 08 1820 LY YSIZE NUMBER OF ROWS TO PUT ON SCREEN 
0 on 

OB TEA AN 06 1880 1 LDY Y. INDEX 

0 80- B BF 08 1850 LDA YTBL.LO,Y COMPUTE THE ROW ADRS 

O884- 69 14 1870 ADC #X.COORD ADD THE X OFFSET 

Se oo og BE Tia ayy 

o8 B- 3 Bo : 1960 ADC #HIRES.PAGE ADD THE HIRES PAGE BITS 
O88p- 85 05 1910 STA T3+] 73 POINTS TO ROW POSITION 
O88F- AC 60 08 1920 LDY X3IZE MBER OF BYTES TO PUT INTO ROW 
0892- 88 1 30 DEY INDEX BEGINS AT ZERO TO XSIZE-1 
0893- B1 00 13 0 .3 LDA (T1),Y GET FRAME DATA 

0895- 91 O4 1950 sta (T3),Y PUT ONTO SCREEN 

0897 8 1820 DEY : FOR ALL BYTES IN THE ROW 
0898- 10 F 1970 PL. 

O89A- E6 0 1980 4 INC Y. INDEX NEXT ROW INDEX 

(1 ae ee 

O89F- 6D 60 08 2010 ADC XSIZE STEP FRAME ADRS AHEAD 
O8A2- 85 00 ~=—- 2020 STA T1 TO NEXT ROW OF DATA 

OBAN- A5 01 2030 LDA T1+1 

iV eae 

O8AA- C6 02 = 2000 DEC T2 COUNT DOW THE ROWS 

O8AC- DO DO _ 2070 BNE .1 GO MOVE REST OF FRAME ROWS 
O8AE- AC 5F 08 2080 LDY INTER. FRAME.DELAY 

O8B1- FO 0B ~—- 2090 BEQ .6 NO DELAY BETWEEN FRAMES 
O8B3- 84 02 ~= 2100 STY T2 SAVE DELAY 

O8B5- AQ 1E  —«- 2110 .5 LDA £30 REPEAT THIS SMALL DELAY 
O8B7- 20 AB FC 2120 JSR MON .WAIT 

O8BA- C6 02. ~—s- 2130 DEC T2 FOR COUNT IN 'T2! 

O8BC- DO F7 ~=— 2140 BNE .5 MORE DELAY 

O8BE- 60 2150 .6 RTS FRAME IS ALL DONE 


DO YOU OWN ONE OF THOSE SMART PRINTERS? 
(But Are Using It With A "Duab’ Interface Board?) 
Now you can get the eost out of your EPSON, NEC, C.JTOH and OKI printers with the PERFORMER board for the 
Apple If and Apple II Plus. This board plugs into any Apple slot and turns your ‘duab’ printer interface 
into a ‘saart’ one. Here’s an exaaple set-up aenu for the NEC 8023A: 


PICA ON t Easy to use! Menu-driven with sieple comsands 
ELITE OFF t Replaces tedious aanual printer set-up 
CONDENSED OFF $ No need to reaeaber those ’ESC’ command sequences 
ENLARGED OFF % The PERFORMER is in RON so its always ‘on-line’ 
ENHANCED OFF t Easy selection of available printer fonts 
LINES/INCH SIX $ Also controls print foraat with dynasic defaults 
PAGE NO. i $ Defaults are easily overridden for saxiause versatility 
COLUMNS 80 % Optional Header line prints Title, Date & Pg 
INDENT 8 Provides Pgi/Pg 2 TEXT or GRAPHICS screen duaps 
FORM LENGTH $ Large foraat graphics in Positive or Negative iaages 
LINES/PAGE % Coapatible with Apple, Tyaac, Epson, Microtek and 
FORM FEED % siailar ‘duab’ Centronics type parallel 1/F boards 
DISPLAY 8 SPECIFY printer: EPSON MXBO W/Graftrax-80 
GRAPHICS % EPSON MX100, EPSON MX80/MX100 W/Graftrax Plus 
DUMP § NEC B023A, C. Itoh 8510 (ProWriter) 

$ OKI Microline 82A/83A W/OKIGRAPH 


PERFORMER BOARD: $49.00 
Avoid A $3.00 Shipping/Handling Charge By Mailing Full Payaent With Order 


RAK - WARE 
41 Ralph Road 
West Orange NJ 97052 
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S&H Software 


presents Apple Il users 


with two chances 
to increase 


speed and productivity 


up to 500%. 


Universal Boot initializer 4.0 will 
work up to 500% faster than 
standard Apple DOS 3.3...$69.95 


The new UBI 4.0 now includes The DOS Enhancer, a DOS 
transparent routine that allows execution of Apple DOS 3.3 files (in 
teger, Applesoft and Binary) up to 500% faster than standard Apple 
DOS—depending on file length. In addition, a new ‘‘FREE"’ command 
in DOS now allows determination of free space on a disk in ‘any siot, 
any drive'’—from the command mode or the program mode. 

UBI 4.0-created disks increase efficiency by breaking the “language 
barrier’ between Apple || hardware and software and breaking the 
“time barrier"’ by loading the RAM card with FPBASIC/INTBASIC (or 
leading assembiers) in 1.7 seconds. This unique combination of 
features greatly increases productivity. copyable disks, one-stage 
booting with DOS 3.3 or DOS 3.2.1 PROMS, fast4oading the RAI. card 
with the “missing BASIC’ (or your favorite utility), fast{B)RUNning or 
fast{B)LOADing your programs and complete compatibility with all 
DOS 3.3 programs. ; 

The new UB! 4.0 package includes the utility disk, training disk, sup- 
port disk, demo disk and complete documentation. System re- 
quirements: Appie |i or Apple || Plus, ROM or RAM card, DOS 3.3 or 
3.2.1 and one or more Gdisk drives. 


Amper-Sort/Merge (A-S/M) works 
up to 500% faster than even 
VisiCorp’s VisiFile™ program...$52.95 


The fastest ‘‘file clerk’’ you've ever met. Of aii the sort utilities 
developed to manage Appie II data files, none does the job nearly so 
fast as Amper-Sort/Merge. 


Here's a quick profile of ““A-S/M"": With 25K of working memory, one 
of five unsorted files can be sort/merged into a single file of up to 125K 
per disk. If a file to be sorted is more than 25K in length, the utility tem- 
porarily lays it aside to be sorted and merged when more memory 
space is available. 

Because sorting routines take up to 50% of the computer running 
time in many business applications, you'll reap continuing benefits hav- 
ing this ‘invisible speed demon’’ on your Apple |i team. We estimate 
that it will save twenty to thirty minutes a day of your “human’’ clerk's 
time—time that would otherwise be spent waiting for ‘‘sort/merge”’ 
operations. 

The A-S/M “speed demon"’ package includes the utility disk, the 
training disk and 24 page instruction manual. System requirements: 
48K Appie Ii, ROM or RAM card, DOS 3.3 and one or more disk drives 
or 48K Appie ti Plus, DOS 3.3 and one or more disk drives. 


To Order. Send Check To S&H Software, Box 5, Manvel, ND 58256 Credit Cards: Phone Cybertronics international Clearinghouse at 212 532-3089. 


Box 6 Manvel ND 68266 
(701) 606-2674 
cauane. FD 
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2170 #* HIRES Y OFFSET TABLES 

2180 ® OFFSET FROM peuouee OR $4000 

2190 * HIRES PAGE DIS 

2200 * USING THESE TABLES SPEEDS UP 
2210 * HIRES SCREEN ADRS COMPUTATION 
ae A GREAT DEAL! 

2240 # FOR EVERY Y VALUE FROM 0-191 
2250 #* THERE IS AN ENTRY IN THIS TABLE 
2260 TO COMPUTE THE ADRS OF FIRST 


aah BYTE IN THE ROW. 


0 
2290 YTBL.LO EQ # 
30 . HS 00000000000000008080808080808080 2890 FRAME4 
10 .HS 00000000000000008080808080808080 2860 «HS 00000000406 1430140714701 
20 HS 00000000000000008080808080808080 2870 -HS 605 80D03207 80F0220380E02 
335 ae 0 tae pono 0000008080808 BABA 808 2880 .HS 6 O71 0078 406 1430100414100 
282828282828 28ABABA a ASA ey 2890 =6.HS ecae 10 a oh 80F00 
329 HS 58282828 2828280 A8A8A gap 2900 .HS 006003000040010000600300 
0 .HS 282828282828282 ABABARABABABABA 2910 #=«.HS O 970070000700 00001C1C00 
2370 «HS PERE CEG EDEOEOSORDROHOEORONGHOND 2920 .HS 0006 30000003600000036000 
2380 HS 5050505050505050D0DODODODODOD 2930 _.HS 400140014001400100000000 
2390 = «.HS 202080202020e00D0DODODODODODODO 2940 FRAME5 
2400 .HS 5050505050505050D0DODODODODODODO 2950 «HS 0000000000000000406 10303 
2410 .HS 3050505050505050D0DODODODODODODO 2960 «HS 4071070320580D0220780F02 


2420 YTBL.HI EQ # 2970 HS ae 80E0360700703406 14301 
2430 =6©.HS 0004080C 1014 1810004080 1014 181¢ 2930 -HS O pee 63100007E3F00 
2440) =¥ HS: -0105090D1115191D 5090D1115191D 2990 HS 0 0F000060030000400100 
2450 «.HS SOROS Ie A IDOCOCORORIZICIAIE 3000 eHS bo 003000070070000700700 
2460 «HS Ne GoOhOBOC IR IhiBlcone ROC IeIh Bie 3010 -HS 001C1C000006 300000036000 
2470 004080C 101418 1CO004080C 1014181C 3020 ~-HS 000360004001400140014001 
2480 He 0105090D1115191D0105090D1115191D 300 FRAME6 
2490 .HS 02060A0E1216 1A1E02060A0E12161A1E 040 ~-HS 00000000406 1430140714701 
2500 ae S BROhOB OCI Rakin ico 30 BECOIR RAB Ic 3020 ~HS 60580D0320 BUN OTpOR ce ind 
2510 004080C 1014181C0004080C 1014181C 060 ~HS eo eoro 370 1430100436100 
2520 HS BORER ee oS ELT DODOE GORDIE TALE 070 eHS a0 PLS Ee gfe O50 
2530 .HS 02060A0E1216 1A1EO02060A0E12161A1E 080 oH 10000 
eeeg gc HS OSOTOROE Ta IT I BIFOSO70BUF 1917 1BIE 3090 one 9979070000700700001¢1c0d 
SS aoe era ae : 00036000 
ecaare # ANIMATION DATA 1D FRANET 400140014001400100000000 
2580 FRAME1 170 ~HS "496 14 0140 date op DE Ope 
. ‘ O7 
2590 HS 000000000000000000600300 140 HS 2 OFO0220 026070070 
2600 ~HS 0070070000580D0000780F00 3125 eHS 40614301004 36 10000463100 
520 SHS. 00 9910000400 10009 BoF00 170 7HS 0040010000 dr9909608300 
2630 ~HS 007C1F00006 §33000 3ibo -HS Boe ee poo Ue Oop coopece 
2640 ~HS 00636300007 36700407 gine 3190 ~HS 000360000003600040014001 
2650 ~-HS 40394E01001 Beo00TBOCO0 3200 CHS S 400140010000000000000000 
B6e0 FRAMED. peconotoecacgiEecee 3550 rm*HS 206003000070070000580000 
2680 ~HS 000000000060030000700700 36 0 eHS por eoe Ore bon onoe 0070 
2690 ~-HS 00580D0000780F0000380E00 240 ~-HS 0660033006 4001300C40011 
2700 -HS 007007000000030000400100 250 ~HS 78780F0E60 e7Fo7 40677301 
2710 -HS 0040010000780F00007C1F00 260 ~HS 004001000060030000700700 
5130 “HS 30 700710070070000380200 3540 © HS Dob boo0K0e 18000006 3000 
2740 Panta tiuritt tat ihhtnta tite 3290 He S pobesounocedoonoecoaeede 
$125 enjlis 00018000000 180000000000 390 FAME Y - ecoboboneSIGOSGTAORAG 
2770 ~HS Coe dos oupe aor onus eupde 3320 ~HS ee 80F0000380E00 


2780 ~=.HS O Bore Oe oOo epoca oor 00700 
660033006 4001300C400118 
2800 += ~«HS 787 BOGEGO F7F07 40677301 


3330  .HS 007007000060030000400100 
ae ec 

2810 .HS 004001000060030000700700 33 
33 


040010000780F00007C 1F00 
50 ~HS 00663300404 141016C60031B 
60 ~HS Se EOE barat 
i$ ~HS 00180C00000C 1800000C 1800 

0 ~HS 000C 1800000C 180000000000 


2820 «HS 00700700001C 1CO0000C 1800 
2830  .HS 000C1800000C 18000006 3000 
2840 «HS 0006 30000000000000000000 
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A Text File Display Command for DOS........Bob Sander-Cederlof 


How many times have you wished that you could see what was in a 
TEXT file? You end up loading a word processor (if you are 
lucky enough to have one that can read normal DOS TEXT files), 
or EXECing it into the S-C Macro Assembler, or writing a 
special Applesoft program.... Why not a DOS command for this 
very common need? 


The June 1982 issue of Call A.P.P.L.E. has an article by Lee 
Reynolds describing the addition of a FILEDUMP command to DOS. 
Lee gives a 20-byte program which fits nicely in an unused 
space in DOS. He replaced the MAXFILES command with 
"“FILEDUMP". In case you want to try it, here are the patches 
for Lee's method. 


JCALL -151 

*BCDF : 20 

*BCEO:8E FD 20 A3 A2 20 8C A6 FO O05 20 FO FD DO F6 20 
*BCFO:FC A2 60 

*AB8E7:46 49 4C 45 44 55 4D DO 

*9D48:DE BC 

*A933:20 30 

*3D0G 


J 


SBCDF-BCF2 is the FILEDUMP command processor. SA8E7-SA8EE is 
the string “FILEDUMP", the command name. The two bytes at 
$9D48,9D49 are the address (minus 1) of the command processor. 
The two bytes at $A933,A934 are flags indicating that the 
FILEDUMP command requires a filename, and can optionally have S 
and D parameters. 


Supercharge Your APPLE II* 


Piug-in compatibility 


320K bytes of RAM (200NS) memory designed 
to function like two 35 track floppy disk drives 


Compatible with Apple DOS 3.3 and Apple 
Pascal 1.1 


Same size as the Apple Disk II° Drive 


Invisible memory refresh - even with the Apple 
turned off 


e Rechargeable battery system built-in to pre 


The Axion RAMDISK™ 320K Memory System for vide 3 hours of auxiliary power 

the Apple Il and Apple Il Plus® provides access 

speeds never before available. The Axlon memory © Slot independent interface board - draws no 
system is designed to interact with Apple DOS power from your Apple 

3.3° and Apple Pascal 1.1° like two standard flop- 

py disk drives while delivering the lightning fast © All firmware is in static RAM on the interface 
access speeds of RAM memory. This also leaves board 

32K of RAM for advanced programming techni- 

ques. The interface board is slot independent and ° Includes software for diagnostic, fast load and 
draws mo power from your Apple. The copy routines, and business applications 


rechargeable battery system built into the unit 
provides three hours of backup in the event of a 


power loss. Drop by your local Apple dealer or y/ \ 170 N. Wolfe Roed, 
contact Axion, Inc. for more information. . 

ae Sunnyvale, CA 940866 
* Trademark of Apple puter, Inc. 
* Pascal is a Trademark of U.C.S.D. Regents AXLON (408) 730-0216 
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My first reaction to the program, being a programmer, was to 


try to modify it. 


The first change I made saved one byte. 
last two instructions are a JSR and an RTS. 


The 
By ending with a 


JMP to the final subroutine, the RTS at BCF2 is not needed. 
Then I tried modifying the order of the loop, and saved another 


three bytes. 


Here is my revised listing: 


1000 Seanmmenn nnn nem www eww nme eee wewe - 
4000 & ®FTLEDUMP*® COMMAND 

A2A3— 1030 DOS.OPEN.TEXT.FILE .EQ $A2A 

A2FC- 1040 DOS .CLOSE. FILE e AQF 

A68C- 1050 DOS.READ.ONE.BYTE eEQ $A68C 

F0- He : MON . COUT 1 eEQ $FDFO 

1080 eOR CDF 
1090 TA $8DF 
1100 FILEDUMP 

BODE- 20 £3 A2 1110 JSR DOS. OPEN. TEXT.FILE 

BCE4= 20 FO FD 1130 at JSR MON.COUT1 

BCET- 20 8¢ A6 1140“ ‘JSR DOS-READ. ONE. BYTE 

BCEC=- 4C FC A2 1180 P JMP DOS.CLOSE. FILE 
1189 oR pa 

ASET- 46 9 AC 

A8ED=- AD et Z eAT /FILEDUMP/ NAME OF FILEDUMP COMMAND 
1220 eOR D48 
1230 oTA Hy; | 

QD48- DE BC Lf 0 ‘ e-DA FILEDUMP-1 BRANCH FOR FILEDUMP COMMAND 
1260 OR $A933 
1270 oTA 833 

A933=- 20 30 1280 eHS 20 FILENAME gma SLOT & DRIVE 
1290 & ARE OPTIONAL 


APPLE MUSIC SYNTHESIZER BREAKTHROUGH 
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e COMPLETE 16 VOICE MUSIC SYNTHESIZER ON ONE CARD, JUST PLUG IT INTO YOUR APPLE, CONNECT THE 


erie Ce coae eure TO YOUR STEREO AND BOOT THE SUPPLIED DISK AND YOU'RE READY TO ENTER 


° IT’S EASY TO PROGRAM MUSIC WITH OUR “COMPOSE” SOFTWARE. YOU'LL START RIGHT AWAY AT 
INPUTTING YOUR FAVORITE SONGS. OUR MANUAL SHOWS YOU HOW, STEP BY STEP. THE HI-RES SCREEN 
SHOWS WHAT YOU'VE ENTERED IN STANDARD SHEET MUSIC FORMAT. 


¢ WE GIVE YOU LOTS OF SOFTWARE. IN ADDITION TO “COMPOSE” AND PLAY PROGRAMS, THE DISK IS FULL 
OF SONGS READY TO RUN. 


¢ FOUR WHITE NOISE GENERATORS (GREAT FOR SOUND EFFECTS). 
¢ PLAYS MUSIC IN TRUE STEREO AS WELL AS TRUE DISCREET QUADRAPHONIC. 


¢ ENVELOPE CONTROL (VOLUME) 


e WILL PLAY SONGS WRITTEN FOR ALF SYNTHESIZER (ALF SOFTWARE WILL NOT TAKE ADVANTAGE OF ALL 
THE FEATURES OF THIS BOARD, THEIR SOFTWARE SOUNDS THE SAME ON OUR SYNTHESIZER). 


¢ AUTOMATIC SHUTOFF ON POWER-UP, OR IF RESET IS PUSHED. 
¢ MANY, MANY MORE FEATURES. 


ALL ORDERS SHIPPED SAME DAY 
SENO $159.00 CHECK OR MONEY ORDER 
(TEXAS RESIDENTS ABD 6% SALES TAX) 


APPLIED ENGINEERING 
P.O. BOX 476301 
DALLAS, TEXAS 75247 


MASTER CHAAGE & VISA WELCOME 


(214) 492-2027 
7:00 AM - 11:00 PM 7 DAYS A WEEK 


APPLE PERIPHERALS ARE OUR ONLY BUSINESS 
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After playing with the new command a little, I thought of 
Several more changes. I wanted to be able to stop the file 
listing, to restart it, and to abort it. The first article I 
ever wrote about Apples described just such an addition, at 
that time for Integer BASIC. (See MICRO, June/July, 1978.) 
With this addition, the program would not fit in the unused 
Space at S$BCDF, so I decided to put it in the place of the INIT 
command instead. I changed the name to "SHOW". 


Not all of the code would fit in the spot where the INIT 
command processor is, at SA54F. Therefore I broke out the 
routine to check for the pause/abort keys as a separate 
subroutine, and placed in over the top of some of the INIT code 
inside the File Manager of DOS. If you install this patch, you 
could call on the PAUSE.CHECK subroutine from your own 
programs. 


1000 @sewetenceuassuccecec cee eeeso ess 
1010 & "SHOW" COMMAND 
A2A3~- 1030 DOS.OPEN.TEXT.FILE .EQ $A2A3 
A2FC- 1040 DOS.CLOSE.FILE -EQ $A2FC 
A68C- 1050 DOS.READ.ONE.BYTE .EQ $A68C 
C000- 1060 KEYBOARD -EQ $C000 
C010- 1070 STROBE -EQ $C010 
FDFO- 1080 MON.COUT1 -EQ $FDFO 
1090. Baeeanaacoseceesanceecc cu aeoescee 
1100 .OR $A5UF 
1110 -TA $84F 
1120 SHOW 
AS4F- 20 A3 A2 1130 JSR DOS.OPEN.TEXT.FILE 
A552- AQ 8D 1140 LDA #$8D 
A554- 20 FO FD 1150 .1 JSR MON.COUT1 
A557- 20 8E AE 1160 JSR PAUSE. CHECK 
A55A- FO 05 1170 BEQ .2 
A55C~ 20 8C AB 1180 JSR DOS.READ.ONE. BYTE 
A55F- DO F 1190 BNE .1 PRINT IT 
A561- 4C FC A2 1200 2 JMP DOS.CLOSE.FILE 
1220 # RETURN .EQ. IF ABORT 
1230 * .NE. IF CONTINUE 
1250 .OR $AE8E OVER "INIT" CODE 
1260 .TA $88E 
1270 PAUSE . CHECK 
AE8E- AD 00 CO 1280 LDA KEYBOARD ANY KEY PRESSED? 
AEQ1- 10 11 1290 BPL .2 NO, CONTINUE 
AE93- 8D 10 CO 1300 STA STROBE YES, CLEAR STROBE 
AE96- C9 8D 1310 CMP #$8D ABORT? 
AE98- FO OA 1320 BEQ . YES, RETURN .EQ. STATUS 
AEQA- AD 00 CO 1330 1 LDA KEYBOARD NO, PAUSE TILL KEYPRESS 
AEQD- 10 FB 1340 BPL .1 NONE PRESSED YET 
AEOF- 8D 10 CO 1350 STA STROBE CLEAR STRO 
AEA2- c9 8D 1360 CMP #$8D ABORT? 
AEAN- 6 0 22 RTS .EQ. IF ABORT 
13 0 .OR gga 
1460 : 
A884- 53 48 4F 
A887- D7 1419 : .AT /SHOW/ SHOW COMMAND NAME 
1430 .OR $A909 
1440 “TA $809 
A909- 20 30 1450 ; -HS 2030 FLAGS FOR SHOW COMMAND 
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29: 


is. 

a. x0 
Q 

eosor 


N.Y. State Residents Add Applicable Sales Tax. 
We Accept Master Charge and Visa. 
include $1.00 handting. 
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After assembling the program above, the various pieces are in 

memory in page 8 and 9, instead of inside DOS. I did it this 

way because DOS is protected during assembly. You can install 
the patches by hex input commands, or by some memory moves. I 
did it this way: 


:SA54F<84F. 863M 

: SAE8E<88E. 8A4M 
:$A884:53 48 4F D7 
:$A909:20 30 


Then try typing "SHOW filename", where "filename" is a text 
file, and see the action. 


You may want to put some POKES in your HELLO file on some disks 
to install the SHOW command. If so, this is what they might 
look like: 


100 DATA 21,42319,32,163,162,169,141,32,240,253,32,142, 
174,240,5,32,140,166,208,243.76,252,162 

110 DATA 23,44686,173,0,192,16,17,141.16,192,201,141, 
240,10,173,0,192,16,251,141.16,192,201,141,96 

120 DATA 4,43140,83,72,79,215 

130 DATA 2,43273,32,48 

140 DATA 0 

150 READ N : IF N THEN READ A : FOR I = 1 TO N : READ D 

: POKE AtI-1,D : NEXT : GO TO 150 


I tried several other versions, with features like clearing the 
screen, filling it up, and waiting; a stand-alone progran, 
rather than a DOS command; and so on. You will probably want 
to try your own experiments. 


Time II 


The most powerful, easiest to use, clock for your APPLE 


© THME IN HOURS, MENUTES AND SECONDS. : a | 
> , 
© DATE WITH YEAR, MONTH, DAY OF WEEK AND LEAP YEAR. soja —§ 


@ FAST DATE AND TIME SETTING. 


@ PROGRAM SELECTABLE 24 HOUR MILITARY FORMAT OR 12 
HOUR WITH Al4iPM FORMAT 

@ WILL ENHANCE PROGRAMS FOR ACCOUNTING, TIME AND 
ENERGY MANAGEMENT, REMOTE CONTROL OF APPLIANCES, 
LABORATORY ANALYSIS, PROCESS CONTROL. AND MORE. 

© DP SWITCH SELECTABLE INTERRUPTS PERMIT FOREGROUND) 
BACKGROUND OPERATION OF TWO PROGRAMS SHMILTA— 


@ INCLUDES DISK CONTAINING MANY TIME ORIENTED UTILITIES, 
@ CRYSTAL CONTROLLED FOR .0805% ACCURACY. PLUS OVER 26 USER CONTRIBUTED PROGRAMS AT NO EXTRA 
© THE EASIEST PROGRAMANNG IN BASIC. Cost. 


@ON BOARD BATTERY BACKUP POWER FOR OVER 4 MONTHS 
POWER OFF OPERATION @ATTERY CHARGES WHEN APPLE 16 © TWENTY-THREE PAGE OPERATING MANUAL INCLUDED, WITH 


MANY EXAMPLES OF PROGRAMS TO USE WITH YOUR APPLE iN 
AMY TION. 

ALL ORDERS SHIPPED SAME DAY 

SEND $129.00 CHECK OR MONEY ORDER 

(TEXAS RESIDENTS ADO 6% SALES TAX) MASTER CHARGE & VISA WELCOME 

ADD $10.00 IF OUTSIDE U.S.A. ml es 
: 214) 492-2027 

APPLIED ENGINEER! 

so NG 7:00 AM - 11:00 PM 7 DAYS A WEEK 

DALLAS, TEXAS 75247 APPLE PERIPHERALS ARE OUR QNLY BUSINESS 
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Hierographic Transport (review) ....cccccccccccese Mike Laumer 


Hierographic Tranport is a Hi-Res printer dump program for the 
Epson series of printers (MX-70, MX-80 and MX-1600). The 
program is a very easy to use, menu driven system. The user 
manual is only 12 pages long, but mest functions are 
self-apparent. I used the program for over an heur before I 
felt the need to refer to the manual. The pregram allows very 
complete control over the dot graphics mode of the Epson 
printers. 


From the menus you can load a Hi-Res picture into either page 1] 
Or page 2. Selections are provided for normal/inverse picture, 
normal/rotated pictures, normal/compressed print mode and a 
setable left margin to allow centering a picture on the page. 


You can control magnifying or scaling the picture from 1 to 99 
times normal size in the X or Y directions. This magnification 
is performed by repeatedly printing each screen dot, in the X 
and Y directions. The magnification only affects the printed 
image and not the screen image. 


There is also the ability to select a "window" from the Hi-Res 
Screen that will be printed on the printer. That way you can 
print the rectangular section of the screen that you are 
interested in. 


The "window" is controlled with two sets of cursor control 
keys. The "“°WASZ" keys control the top and left sides of the 
cursor. While the familiar "“IJKM" keys control the right and 
bottom sides of the cursor. This is adequate for controlling 
the “window" but I would have prefered one set to control 
inward movement of the cursor sides and the other set to 
control outward movement of the cursor sides. 


The cursor is presented as a set of blinking lines overlayed on 
the picture image. This technique uses the HXPLOT function 
described in the June issue of AAL. This function allows 
non-destructive lines to be drawn and erased over the top of an 
image on the Hi-Res screen. 


The cursor lines are automatically stepped by an amount from 
1-9, selectable by the number keys. The space bar or any other 
valid command key will stop the cursor from advancing. If "0" 
is selected for the step distance, the cursor lines will step 
by 1 whenever a cursor control key is pressed. This allows a 
fine positioning mechanisn. 


Once a “window" is selected the user can have it printed on his 
printer. When this is selected, the program automatically 
checks up on the parameters you have selected and computes the 
size of the image as it should be on the printer. If you have 
scaled the image too big, an error message will result. 


The overall design of the program is good. There are however, 
a few minor problems in operation of the program. When the 
"window" is very large the automatic steps in advancing the 
“window” occur slowly. As the size of the “window” gets 
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DOS FILE EXCHANGE (DFX) $45.00 


This has to be the neatest APPLE-to-APPLE DOS 3.3 file transfer 
program that you have ever seen! For the low price of $45.00 we will 
supply you with a DFX disk that contains a special utility that can 
transmit and save-to-disk a secondary copy of the DFX to a remote 


APPLE I!. Thereafter, you may both dial-out, auto-answer, check- 
off any standard DOS 3.3 files for error checked transfer and then 
see both data streams or HIRES pictures as they arrive. All this 


and you may both exchange messages at the same time! There is 

no need to sit there doing nothing while a long selection of files is 
being transferred, type away, it will not interfere with any of the 
file data. Documentation is supplied as a print program and a DOS 
TEXT file so that you and your remote friend may reproduce your 
own hard copies. 


REFLEXIVE VC (RVC) $45.00 


You can synchronize two VisiCalc programs over the phone! We send 
you two RVC disks so that you and the person at a remote site may 
place a call between your APPLES, run the RVC program and then 
you both load your 16 sector VisiCalc program disks. Now the magic 
begins! If you both insert disks that contain exact copies of the 
same VisiCalc data files, either of you may then load a file and 
start manipulating the VisiCalc screen and BOTH APPLES will re- 
act in exactly the same way at the same time! You can even type 
messages to each other. Also, should either one of you initiate a 
VisiCalc save-to-disk command, both of you will have disk copies 
of the current modified VisiCalc model. RVC is virtually trans- 
parent to VisiCalc commands so now you both have a very powerful 
TELECONFERENCING system. Each RVC disk contains a program 
that prints the documentation and an RVC demonstration file. 


DFX and RVC both require 48k APPLE I!+ or APPLE [If with Language 
card or APPLESOFT in ROM, a Hayes Micromodem I]! in slot 2, and 
Disk Il in slot 6. You will also need to have a copy of the 16 sector 
VisiCalc program disk from VisiCorp at each end to run RVC. 


RVC and DFX make an unbeatable combination so if you order them 
both at the same time, we will be happy to pay shipping charges. 
Otherwise please add $2.00. 


To order, please write or phone: - 


ARROW MICRO SOFTWARE 
Box 13252, KANATA, ONT. CANADA K2K 1X4 


(613) 592-4609 


* VisiCalc is a registered trademark of VisiCorp. 
* APPLE II is a registered trademark of Apple Computer, Inc. 
* HAYES MICROMODEM II is a trademark of 

Hayes Microcomputer Products, Inc. 
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smaller, the speed of the automatic advance gets very fast 
making it hard to stop on the exact point you want. The cursor 
routine needs a delay which varies by the size of the “window” 
to help even out the speed of the automatic cursor advance, 


There is a record of data kept at the bottom of the screen when 
you are selecting a "window". This data provides you with the 
cursor locations and a unique display of the computed size of 
the picture to be printed. As the cursor is moved, the data is 
updated to the new recomputed picture size. The size display 
often flickers because blanks are written to the screen and 
then the data is written. If the data were written then the 
line cleared to the end of line, the flicker would be less 
noticeable. 


The size display had the only bug in the whole program that I 
could find. The bug is rather trivial and does not affect the 
quality of the program. A bug, however, is a bug! [ I am sure 
they will fix it, once they read this review. ] When a very 
large scale factor (99 x 99) is used, the routine to print out 
the size goes bananas and displays some garbage characters on 
the screen. When compressed printing is selected (where the 
dot spacing on the Epson goes from 1/60 of an inch to 1/120 of 
an inch on the horizontal direction), the size display goes one 
character too far and scrolls the data up the screen. As the 
cursor window is moved arround the scrolling eventually scrolls 
the title lines off the main menu. 


Unless you plan to print a wall mural for the side of your 
barn, you should never encounter the problem. A 99 x 99 
scaling factor will give a pixel size of 1.5 inches square! A 
full screen print would be 38 feet by 21 feet in size!!! 
That's way beyond the carriage width of even the MX-100. The 
program could handle it though as long as you print it in 
narrow window strips. (A nice future enhancement would be for 
the program to automatically print an oversize picture in 
strips sized for your particular printer.) 


The program has a built in configuration routine and can easily 
be configured for the following interfaces: 


Epson APL 

CPS Multi-function 

Grappler 

Micro Buffer II 

Prometheus 

Apple parallel 

Epson APL (modified for 8 bit Transmission) 


The Epson printers are very popular, but many more brands of 
printers are now on the market which have comparable 
capabilities. For example, the NEC PC-8023, the MPI-88G, and 
the Okidata series. I hope that the GSR folks come out with 
equivalent “Transports” for these other printers. All of them 
on the same disk would be especially nice! 
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Conclusion: A fine program for graphics printer dumping. I 
rate this program a "B+". A little attention to its few 
problems would raise the grade to "A", 


This program is sold for $39.00 and is available from GSR 
Associates, P.O. Box 401462, Garland, Texas 75040. (Don't be 
afraid of the P. O. Box, they are real people.) 


OFTEN WONDER HOW MACHINE LANGUAGE PROGRAMS WORK? 
Well stop wondering and do something about it! Use DISASM to convert 6502 machine code into aeaningful, 
syabolic source. Create a text file which is directly compatable with DOS ToolKit, LISA and S-C (both 4.0 
& Macro) Asseablers. DISASM handles data tables, displaced object code and even lets you substitute 
MEANINGFUL labels of your own choice (100 comaonly used Monitor & Pq Zero names included in Source fora to 


get you rolling). An address-based cross reference table provides even sore insight into the inner 
workings of machine language prograss. DISASM is an invaluable aid for both the novice and expert alike. 
DISASM (Version 2.2): $30.00 


The ’MIRROR’s: Firmware for Apple-Cat 
Comaunications ROM plugs directly into Novation’s aodea card. Three basic modes: Duab Terminal, Reaote 
Console & Prograamable Modes. Added features include: Printer buffer, Pulse or Tone dialing, true 
dialtone detection, audible ring detect and ring-back option. Supports VIDEX 80-coluan board and Apple’s 
Coma card comeands. (Hardware differences prevent 100% interchangability with Coes card.) 
ROM & User’s Manual: $29.90 


Utilities For Your S-C Assembler (4.0) 
SC.GSR: A Global Search and Replace Eliminates Tedious Nanual Renaming Of Labels......sseeeee B2O0.00 
SC.XREF: A Linenuaber-Based Global Cross Reference Table For Coaplete Source Docusentation... $20.00 
SC.TAB: Tabulates Source Files Into Neat, Readable Fora. Encourages Fast, Free-Foraat Entry. $15.00 
SC UTILITY PAK: Includes All Three Utilities Described Above (You Save $10.00). ..sccsccsseeee P4542 00 


Avoid A $3.00 Shipping/Handling Charge By Mailing Full Payaent With Order 
RAK - WARE 
41 Ralph Road 
West Orange NJ 07052 


$34a2 GAY YOU SAW IT IN "APPLE ASSEMBLY LINE’! sage 
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Christmas in JulLy?...ccccccccvevevcceseveeeeBOD Sander-—Cederlof 


Mike Laumer has decided to offer a special price to readers of 
Apple Assembly Line on his FLASH! Integer BASIC Compiler. For 
a limited time, AAL readers can buy FLASH! for only $49, a 
Savings of almost 40% from the normal $79 price. The offer 
expires September 1. 1982, and is limited to one per customer. 
To qualify you must mention that you read about it in AAL. and 
call or write directly to Laumer ReSearch. Mike's phone is 
(214) 245-3927; write to 1832 School Road, Carrollton, TX 
75006. 


What a bargain! The FLASH! compiler is an incredible software 
design tool which can translate Integer BASIC programs into 
extremely fast machine language programs. It is the only full 
feature compiler on the market that can provide assembly 
language listings and source files compatible with my S-C 
Assemblers. 


Synergistic Software is now selling the Galfo Integer BASIC 
Compiler for $149; it is copy protected, has no assembly 
language output, fewer extensions to the language, an 
undocumented run-time package, and no option to buy the 
run-time package source code. I have heard that it is a good 
compiler, but I think the price is too high. 


FLASH!, on the other hand, is NOT copy protected. You can make 
as many copies for your own use as you need. FLASH! adds 
features for hi-res graphics and system programming to the 
Integer BASIC language. The FLASH! run-time package is fully 
documented, and owners of FLASH! can get the source code of the 
run-time package on disk for only $39. FLASH! allows easy 
relocation of the object code for any requirements. Used in 
combination with the S-C Assembler. you can further optimize 
the object code for even greater memory and time savings. And 
at this special price, it truly is a bargain. Christmas in 
July! 
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